home *** CD-ROM | disk | FTP | other *** search
/ Mac Magazin/MacEasy 14 / Mac Magazin and MacEasy Magazine CD - Issue 14.iso / Online / html / HTMLedit17.fat / HTMLedit17.Readme.txt < prev    next >
Text File  |  1995-09-05  |  22KB  |  415 lines

  1.  
  2. HTML.edit 1.7 for Macintosh - ReadMe
  3.  
  4. HTML.edit ©1994, 1995 Murray M. Altheim, Equinox Development, All Rights Reserved.
  5. Please read the Legaleze section under HTML.edit Help for information regarding copyrights, credits and distribution.
  6.  
  7.  
  8. ####   Availability    ****
  9.  
  10. Information on current versions is now available at
  11.  
  12.    http://ogopogo.nttc.edu/tools/htmledit/HTMLedit.html
  13.  
  14. Non-beta versions of HTML.edit are distributed worldwide via sumex, umich and their mirrors.
  15.  
  16. Information on bugs and fixes is available at
  17.  
  18.    http://ogopogo.nttc.edu/tools/htmledit/bugs.html
  19.  
  20. Please email any comments or problems you find with this version to the author at
  21.  
  22.    murray.altheim@nttc.edu
  23.  
  24.  
  25. ####   NOTES ON HTML.edit v1.7.0:   ****
  26.  
  27. Also see the section "New Features" under Help. 
  28.  
  29. No Usage Restrictions
  30. Please note that I have removed the commercial use restriction on HTML.edit. However, all distribution restrictions, copyright and intellectual property protections remain unchanged. Please see the Legaleze section under Help for more information.
  31.  
  32. Insert Export String --> Insert Custom Entity
  33. Previous versions allowed the insertion of text strings that were optionally translated upon export into date or time information. These strings were in the form "{Abbreviated Date}" using curly brackets. This version now uses an SGML entity-style format as the inserted string, such as "&date;" or "&time;".  Existing documents using the curly bracket strings should be changed to the new format using a global replacement to the new format as shown below:
  34.  
  35.    Old Format                      New Format
  36.    {Short Date}                     &date;
  37.    {Abbreviated Date}               &abbrevDate;
  38.    {Long Date}                      &longDate;
  39.    {Time}                           &time;
  40.    {Long Time}                      &longTime;
  41.  
  42. Use the Replace command (under the Utility menu) with the options set to "All Occurrences" and "All Documents". If you are transferring documents between versions of HTML.edit, uncheck the option "Translate Entities on Export" on Import/Export Preferences.
  43.  
  44. Footers
  45. HTML.edit defines a footer as any text following the <!--FOOT--> tag used as a separator, regardless of whether this tag occurs in the Body or Footer text areas of the editor. The separator is an HTML comment, which should be ignored by WWW browsers, and can be modified from the Preferences card. I use this feature to automatically cue HTML.edit to separate out the footer text on imported documents. Modifying the "footer" of many documents is then simplified.
  46.  
  47. Help
  48. If you are upgrading from a previous version, please check the "Installing HTML.edit" section in Help, especially if you notice any anomalies with the Futura display font. There is no longer any font suitcase to install.
  49.  
  50. Note that previous versions of HTML.edit included the HTML documents "Mosaic for X version 2.0 Fill-Out Form Support" (courtesy NCSA) and "HTML and SGML" (which is part of Dave Raggett's HTML 3.0 draft). These online documents are now referenced via the Browse Hotlist submenu under the tool palette's Preview menu.
  51.  
  52. Hotlist Menu
  53. Please note that the current version does not support semicolons on the Hotlist menu, either in the URL itself or in the displayed menu text.
  54.  
  55. Miscellaneous
  56. Check the "New Features" Help section as well as the Change History below for details on new features. 
  57.  
  58.  
  59. ####   Change History   ****
  60.  
  61. See online Bug List/History document
  62.  
  63.    http://ogopogo.nttc.edu/tools/htmledit/bugs/html
  64.  
  65. for extended history.
  66.  
  67. (1.7d165/1.7.0 1995.09.04)
  68.  - added Balloon Help for many Prefs options
  69.  - speeded up transition between Prefs sections
  70.  - added overflow checking on Index
  71.  - final cleanup for release
  72.  
  73. (1.7d164 1995.08.31)
  74.  - fixed: resizing label area on Index disabled clicking on scroll bar grey area
  75.  - Index now properly sorts by path (up to six levels deep)
  76.  - fixed problem with displaying multi-line TITLE in Index
  77.  - fixed: wasn't remembering palette locations
  78.  - now displays Label in editor window with popUp selector menu
  79.  - fixed footer utility table resize bug on small windows
  80.  - ALT attribute on IMG now limited to 1024 characters; option to translate <>&" to entities
  81.  - added 'Date & Time' to available custom entities on Utility menu
  82.  - browser Preview (Command-J) now works on Master Headers and Footers
  83.  - added right margin indicator (vertical line) to ruler
  84.  
  85. (1.7d163 1995.08.24)
  86.  - Command-Option-F displays new Find Tool. Check Balloon Help for description.
  87.  - no longer re-indexes when changing document path or name
  88.  - fixed some field updating problems with Anchor Utility
  89.  - fixed some user-interface uglies with Anchor and Footer Utilities
  90.  - changed user interface details on Element Index, Find, Keywords and URL field
  91.  - Element Index can now be resized vertically using a divider
  92.  - fixed errors in Help documentation on BASE and META
  93.  - fixed relative path bug in URL field on documents selected from URL popUp menu
  94.  
  95. (1.7d162 1995.08.23)
  96.  - no longer re-indexes when changing path to a file
  97.  - fixed touchlink problem with documents having no set path
  98.  - fixed browser request dialog
  99.  - no binks option on Editor Preferences
  100.  - shift-select multiple documents using up and down arrow keys on Index
  101.  - shift-enter selects the current physical line in editor
  102.  - eliminates any standard bullets (ie., "•*∑®‡fi") from lists on translation
  103.  - added BODY with attributes to Remove HTML command
  104.  
  105. (1.7d157 1995.08.17)
  106.  - global replace by specified document label
  107.  - holding down Shift on QuickLink with zero length selection inserts first H1 of target as hypertext
  108.  - holding down Option on QuickLink with zero length selection inserts TITLE of target as hypertext
  109.  - properly handles BODY tags with attributes
  110.  - improved error handling on browser interaction
  111.  - QuickLink to Selected Document now uses wider dialog box when listing TITLEs or pathnames
  112.  - eliminated some globals to save memory
  113.  
  114. (1.7d151 1995.08.12)
  115.  - fixed freeSize/Editor Size display on Compacting Preferences (now truly in 'K')
  116.  - command-option-B: insert BASE in current document
  117.  - export of Help text: MS Word/HTML version based on d151
  118.  - added "\f" (=form feed) to miniGREP metacharacters
  119.  - added storage of Preferences file name
  120.  
  121. (1.7d147/b9 1995.08.08)
  122.  - fixed Restore Path from BASE (Import option) handling of BASE elements that refer
  123.    to a directory rather than a document 
  124.  - removed extraneous dialog on Browse
  125.  - changed method of storing path to WWW browser on Browse; now via Set button on Prefs
  126.  - fixed size of disabled Label field on Labels Preferences
  127.  - improved trapping of shift and option keys on shortcuts
  128.  - reorganized Help
  129.  - added "\q" (=quote) to miniGREP metacharacters
  130.  - new Uncomment command (Command-Plus) and reorganized HyperText menu
  131.  
  132. (1.7d143/b8 1995.08.02)
  133.  - new Paste File command (Edit menu) pastes an imported text file at the insertion point
  134.  - added Convert Tab to "\t" (or other custom string) on Import; tabs are not allowed in HTML
  135.  
  136. (1.7d141 1995.08.01)
  137.  - new feature to save settings to and restore from a Preferences file
  138.  - added optional WIDTH attribute on PRE, COMPACT attribute on lists (optionKey on menu)
  139.  - implemented Michael Bradshaw's Progression XCMD in place of earlier progress bar
  140.  - added a return character after ADDRESS and list elements
  141.  - now correctly sets the http server name when requested from Editor window
  142.  - Preferences fields now resize properly to fit smaller windows
  143.  - fixed window update bug in navigating to different background after resizing window
  144.  - now hotlist and image library allow commas (semicolons will show up in menu or URL as colons)
  145.  
  146. (1.7d133 1995.07.26)
  147.  - Export Conversion option: translates characters or strings to entities on export (©, ü, é, etc.)
  148.  - fixed some small bugs on Prefs
  149.  - Font menu on Index now hierarchical
  150.  - Insert Entity window now available from Windows menu at any time
  151.  - changed order of conversion on export so that entities in headers/footers will be converted properly
  152.  - finally located the Indexed status bug (the Index didn't always know it needed updating)
  153.  
  154. (1.7d128/b7 1995.07.09)
  155.  - I think I finally got the URL field working as advertised, both absolutely and relatively
  156.  - now properly clears Anchor Utility's Fragment ID field when selecting from Hotlist
  157.  - now asks for default HTTP server name if not set on opening Anchor Utility
  158.  -  'Set' button on Prefs wasn't setting path correctly; fixed bug in
  159.    drivePath XFCN; was not resetting item delimiter to comma
  160.  - caught a few more missing links in the hypertext Help
  161.  - fixed a few more Index bugs - adding View by Title has been a real headache
  162.  
  163. (1.7d127/b6 1995.07.07)
  164.  - still a bug in TouchLinks to documents in the same folder: URL incorrect.
  165.  
  166. (1.7d124 1995.07.05)
  167.  - I don't know about anybody else, but I finally removed that annoying initial
  168.    return character when typing option-return
  169.  - Indexed status was not always being set correctly - I think this bug is now dead
  170.  - fixed named anchor popUp on Anchor Utility by rewriting attribute parser
  171.  - Default Settings bugs fixed
  172.  - Default Settings now only sets to default the visible Preferences section, not all sections
  173.  - Preferences sections now selected via button rather than popUp menu
  174.  - now truncating at 64 character limit on TITLE as per DTD
  175.  
  176. (1.7d122 1995.07.04)
  177.  - rewrote duplicate label checker: was finding partial word matches
  178.  - fixed document selection bug on Index
  179.  - changed resize window on Prefs to better reflect window size
  180.  - rewrote locator for HEAD insertion point: BASE insertion overlapped other tag if not on own line
  181.  
  182. (1.7d120/b5 1995.07.02)
  183.  - new Welcome to HTML.edit document
  184.  - now available: a simplified palette option (checkbox on Editor Preferences)
  185.  - rewrote attribute parser to handle single or double quotes as well as extra spaces
  186.    and returns; now also checks for balanced quotes
  187.  - TT is now called "Teletype" not "Typewriter" to match HTML 2.0 DTD (yccch)
  188.  - removed the 2.0 deprecated "LISTING" format from the HTML menu
  189.  
  190. (1.7d117 1995.06.30)
  191.  - optionally break imported document into separate documents
  192.    at formFeed (ASCII 12) or custom character
  193.  - fixed importer to break document on word boundary when overflowing into footer field
  194.  - added report templates for printing from Index, and enabled printing Index contents
  195.  
  196. (1.7d115 1995.06.29)
  197.  - added XFCN replacements for nine handlers
  198.  - entity maps no longer stored in memory
  199.  - shrunk size of Entity window about 30% and added © and ®.
  200.  - added Keywords utility: click on words in document to add to list (used by META)
  201.  - added HTTP-EQUIV popUp menu to META dialog; uses current selection
  202.    if keywords field is empty
  203.  - uses wider dialog box when selecting documents using path or title
  204.  
  205. (1.7d110 1995.06.26)
  206.  - fixed text resize bug on Clip Library preferences
  207.  - removed "Show Path" buttons from Index and Prefs, and added option to Index popUp menu
  208.    to choose display content of Index: Document Name, Title or Path
  209.  - changed "Glossary" command to "Definition" command to match HTML 2.0 DTD (duh...)
  210.  
  211. (1.7d107 1995.06.22)
  212.  - last line in Index no longer cut in half -- scroll works properly now too.
  213.  
  214. (1.7d105/b4 6/18/95)
  215.  - added Restore Path and Insert BASE commands to Index card's popup menu
  216.  
  217. (1.7d103 1995.06.16)
  218.  - fixed problem with beeping loop on Clip Library
  219.  - option-click on prev or next buttons to view prev or next document name
  220.  - fixed Export As command (now asks for new name)
  221.  - imported documents not part of server path get annoying message
  222.  - added resize box to Preferences card
  223.  - Hotlist, Clip and Image Libraries now import/export to text files
  224.  - Hotlist now imports Mosaic and Netscape bookmark files (Netscape users must "Export" their Hotlist)
  225.  
  226. (1.7d98 1995.06.14)
  227.  - working on URL popUp (problem with URL text not updating properly)
  228.  - changed Header/Footer toggle icon to Apple Alarm Clock-style latch
  229.  - added horizontal scroll bar to Table Utility
  230.  - fixed SGML Prologue duplications on HTML Language command
  231.  
  232. (1.7d92 1995.06.10)
  233.  - Hotlist now available from Anchor Utility and Preview menu, and uses HTML anchor format
  234.    to allow for labelling of URLs on menus (you select the hypertext link, and the associated URL is entered).
  235.  
  236. (1.7d90 1995.06.09)
  237.  - Preview button now a popUp menu supporting browser "OpenURL" preview via BASE element,
  238.    manually entered, or from hotlist. Option-click to simply Preview via old method of opening text file.
  239.  - Jon Pugh confirms problem with disabled text on popUp is due to
  240.    limitation of menu manager - disabled text good thru first 31 lines max
  241.  
  242. (1.7d88 1995.06.06)
  243.  - updated HPopUpMenu XFCN to 3.3.1; still problem when dealing with large amounts of disabled text
  244.  - still working on Table Utility…
  245.  - fixed bug in elapsed timer: now works properly and works up to 1 year before rolling over
  246.  - updated Palette Help (color and new stuff)
  247.  - fixed bug where after moving application window could hide redisplayed Tool Palette partially under menubar
  248.  - changed "Compact Stack" command to "Compact"
  249.  
  250. (1.7d83 1995.05.30)
  251.  - added new Table Utility card (Command-Shift-T to go there)
  252.  - Preview now has shortcut Command-J (works from any document, master header or footer)
  253.  - added List Item to HTML Format menu, with shortcut Command-L
  254.  - Clip Library's shortcut now Command-Shift-L
  255.  
  256. (1.7d76 1995.05.30)
  257.  - rewrote Index and Hilight HTML handlers (Index now much faster, Hilight had bugs);
  258.    added font selection on Hilight
  259.  - HTML Title now uses first <H1> in document as default text
  260.  - added 2 optional attributes as popups on Anchor Utility (using mailbox latch to enlarge)
  261.    ID, URN, REL, REV, TITLE, METHOD
  262.  - fixed a few things to make it load a bit faster
  263.  
  264. (1.7d73 1995.05.27)
  265.  - Server button on Anchor Utility wasn't updating server URL "sample" field on Prefs
  266.  - checks for existence of BASE element on import and sets target path accordingly
  267.  - added RestorePath handler to recreate fullPathName from existing BASE element
  268.  - Remove HTML now also reconverts entities
  269.  - now maintains selection after Remove HTML, Unwrap, Convert Entities, Reconvert Entities and Table Convert
  270.  - now traps Command-Shift-O (oh); was setting text as outline style
  271.  - Preprocess Text now preprocess, table, entity and paragraph converts; works in reverse on optionkey
  272.  - restores selection on show/hide header & footer and drag header/footer size
  273.  - better handling of return characters on Convert ¶ to <P> (in both directions)
  274.  - Unwrap Text now preserves spaces (ie., returns) between paragraphs
  275.  
  276. (1.7d72/b3 1995.05.26)
  277.  - fixed problem with URL relative path creation on TouchLink and QuickLink
  278.  - now maintains selection after insertion of link on TouchLink and QuickLink
  279.  - fixed annoying rename attempt on Import from Index card
  280.  - now properly disables unused custom entity items in Utility submenu
  281.  
  282. (1.7d70/b2 1995.05.25)
  283.  - reimplemented fullSFPack XFCN for getting folder paths due to apparent bug in HC answer folder
  284.  - fixed minor text errors in Help and added shortcut keys to Table Menu graphic on Palette Help
  285.  - fixed bug in Export and Export As… commands from menubar File menu on Index
  286.  - added Duplicate Document command
  287.  - now trapping "help" button and calling HTMLHelp instead of HyperCard Help
  288.  - now trapping "home" and "end" to go to Index and Preferences respectively
  289.  - updated Format palette to match HTML format submenu (and 2.0 DTD)
  290.  
  291. (1.7d68/b1 1995.05.20)
  292.  - now properly restores selection on redo and disables Undo menu item when appropriate
  293.  - supports META element (under HTML Structure submenu) allowing simplified search attributes:
  294.  
  295.    <META name="resource-type" content=document>
  296.    <META name="description" content="text description"> 
  297.    <META name="keywords" content="keyword1,keyword2,keyword3">
  298.    <META name="distribution" content=global> 
  299.  
  300.  - now transfers META elements to <HEAD> section
  301.  - Default Settings button now restores conversion and HTML style tables (no RTF yet)
  302.  - fixed URL creation from URL field on Anchor Utility
  303.  - Anchor Utility now sets URL field on named anchors
  304.  - fixed bug in getAttrList (gets attribute list for popUps, etc.)
  305.    now handles quoted and unquoted attributes and finds unbalanced quotes
  306.  - fixed bug in uniqueness check of Custom Entity names
  307.  - command left arrow to go back through the Help topics you've browsed
  308.  - click on associated document name in Custom Entity table to go there
  309.  - changed Go Master Headers and Footers to selection of specific header or footer
  310.  - table of contents for named anchors within documents
  311.  - fixed bug in character count on imports over 30K
  312.  
  313. (1.7d64 1995.05.19)
  314.  - prev, next and selected links (Command 7,8 and 9 respectively) now work without
  315.    Anchor Utility, and add correct server folder path when available.
  316.  - added diversion to Utility menu
  317.  - added window size Maximize button
  318.  
  319. (1.7d63 1995.05.18)
  320.  - added maximize button on Editor window, and changed behavior of window size popUp (no optionkey)
  321.  - added option to change background color of Help
  322.  - new document now asks for name rather than using default "Untitled-x.html"
  323.  - replaced fullSFPack XFCN with HC 2.3 "answer folder"
  324.  - uses URL field as container for creating HREFs on Quick HyperText Link and TouchLink ("HotLink") commands
  325.  - ironed out most of the kinks in TouchLink™, esp. updating URL field between documents (server path aware)
  326.  - reorganized Help, rewrote some sections
  327.  - added elapsed time counter (wish I'd done that first!)
  328.  - changed appearance of Prefs card to match other backgrounds
  329.  
  330. (1.7d58 1995.05.16)
  331.  - now avoids nasty recursive loop when inserting document into itself using custom entities
  332.  - new custom entity choice from popUp only changes existing entity after asking -- custom dialog box
  333.  - custom entities now cleaned for spaces, commas, pound (#) signs, extra ampersands and semicolons
  334.    and checked against Latin 1 and existing custom entity lists.
  335.  
  336. (1.7d55 1995.05.14)
  337.  - modifiable Font menu: new Physical and Semantic Styles tables on Prefs card
  338.  - SGML Prologue popUp menu/table on Prefs card now customizable
  339.  - updated command language to match HTML 2.0 DTD (May 6, 1995 draft)
  340.  - rewrote Footer Utility resize handler
  341.  - popUp on sample text on Footer Utility for font and size
  342.  - added 'Date & Time' format to Footer Utility
  343.  - adding multi-format email address to Footer Utility
  344.  - added Copy from… button to Footer Utility to copy Author/Curator table
  345.  - fixed Clear button on Footer Utility
  346.  - rewrote custom entity handler
  347.  - added 1 pixel drop shadow to all windows for consistency
  348.  - fixed resize bugs on all backgrounds
  349.  - fixed tools palette forgetting its location when hidden
  350.  
  351. (1.7d50 1995.05.10)
  352.  - PowerMac native version
  353.  - added Format, Form and Table palettes
  354.  - rewrote all palette handling
  355.  - fixed all bg resizing problems due to new XFCN (?)
  356.  - now disallows commas and semicolons in filenames
  357.  
  358. (1.7d48 1995.05.09)
  359.  - blocked option-tab display of HC tools palette
  360.  - finished up new resize handlers with maximum window size
  361.    limited only by memory: card sizes up to 1024 x 1024.
  362.  - fixed window resize popUps; added Maximize item to resize to current screen (up to 1024 x 1024)
  363.  - new Preprocess Text command (ala Dave Raggett's suggestion) to convert HTML reserved
  364.    characters (genericized Table Convert to accept any table)
  365.  - added Preprocess Text table to Conversion Preferences
  366.  
  367. (1.7d44 1995.05.04)
  368.  - substituted GrowBox for FullDrag XFCN to allow for less cumbersome window sizing (still need to fix MF)
  369.  - cleaned up small problems and added to Table Conversion commands
  370.  - broke Conversion section into three areas:  Table Conversion, Custom Entity Conversion,
  371.    and RTF Conversion
  372.  - Custom Entity conversion on export now includes documents, not just master headers and footers
  373.  
  374. (1.7d35 1995.04.30)
  375.  - if a complete heading element (i.e., "<H1>Heading Text</H1>") is selected,
  376.    choosing a heading level will alter the heading level rather than add new tags
  377.  - change Export String curly braces usage to SGML-style custom entities (&date;, &time;, etc.)
  378.  - added new feature: translate SGML-style custom entities on export 
  379.    as contents of a selected master header or footer
  380.  - removed redundant part of Header area popUp menu for consistency with Footer popUp
  381.  
  382. (1.7d28 1995.04.29)
  383.  - fixed bug with scrolling items in Text Lookup Table - now uses two item table rather
  384.    than two scrolling fields, so now source can be longer string instead of just single character
  385. - removed support for nonstandard <!-- comments > (now follows HTML2.0 spec only)
  386.  
  387. (1.7d28 1995.04.22)
  388.  - now supports all forms tags
  389.  - Palette Help updated for forms
  390.  - Remove HTML now removes forms tags
  391.  - fixed bug in "Choose a Document" under Go menu on Prefs card
  392.  
  393. (1.7d20 1995.04.17)
  394.  - now maintains selection when inserting basic tags while Info window is visible
  395.  - added beginning of simple Forms input
  396.  - RTF export now seems to be moving faster than RTF import (simpler)
  397.  - fixed bug in Anchor menu responding to base of hierarchical menu with no item
  398.  - fixed bug in inserting TITLE into middle of <HE<TITLE>AD>
  399.  
  400. (1.7d17 1995.04.14)
  401.  - fixed problem where path was showing up in document selection dialog
  402.  - fixed thermometer on Hilite Anchors
  403.  - fixed problem on HyperText Link to Selected Document: locktext not working properly
  404.  - eliminated Line Feeds commands; server platform-based auto-filter on import/export (prefs)
  405.  - now overflow text over 30K into footer field on import (new 60K limit on imports)
  406.  
  407. (1.7d13 1995.04.12)
  408.  - restructured Anchor popUp menu and added Hot Link (working title)
  409.  - added bookmarks feature under Utility popup menu
  410.  - Hotlist & Image Library name now changed to Libraries Preferences
  411.  - added Clip Library window and Edit menu commands (contents on Libraries Preferences)
  412.  - fixed bug in remembering location of tool palette
  413.  - now remembers rect of Info and Clip Library windows
  414.  - changed max window from 640 x 824 to 704 x 720 (same memory req.)
  415.